// ============================================================================
//
// LCP-net framework by Pierre CHATEL chatelp@gmail.com
// Distributed under GPLv3
// Copyright (C) THALES Land & Joint Systems, 2008, 2009. All rights reserved
//
// ============================================================================

/**
 * <copyright>
 * </copyright>
 *
 * $Id$
 */
package com.thalesgroup.preferenceFramework.models.LCPnet;

import com.thalesgroup.preferenceFramework.models.LCPnet.exceptions.LCPnetEvaluationException;
import com.thalesgroup.preferenceFramework.models.Outcome;

/**
 * <!-- begin-user-doc -->
 * A representation of the model object '<em><b>COutcome</b></em>'.
 * <!-- end-user-doc -->
 *
 *
 * @see com.thalesgroup.preferenceFramework.models.LCPnet.LCPnetPackage#getCOutcome()
 * @model
 * @generated
 */
public interface COutcome extends Outcome {
	/**
	 * <!-- begin-user-doc -->
	 * <!-- end-user-doc -->
	 * @model kind="operation" required="true" exceptions="com.thalesgroup.preferenceFramework.models.LCPnet.exceptions.LCPnetEvaluationException"
	 * @generated
	 */
	LTwoTuple getLinguisticUtility() throws LCPnetEvaluationException;

	/**
	 * Compares two COutcomes based on their utility value.
	 * 
	 * @param anotherOutcome
	 *            the outcome to be compared.
	 * @return the value 0 if the argument outcome is equal to this outcome; a
	 *         value less than 0 if this outcome has a lower utility value than
	 *         the outcome argument; and a value greater than 0 if this outcome
	 *         has a higher utility value. than the string argument.
	 * 
	 * @model required="true" anotherOutcomeRequired="true"
	 * @generated
	 */
	double compareTo(COutcome anotherOutcome) throws LCPnetEvaluationException;

	/**
	 * Computes the global utility of this outcome.
	 * 
	 * @model kind="operation" required="true"
	 * @return the global utility of this outcome
	 * @generated
	 */
	double getUtility() throws LCPnetEvaluationException;

} // COutcome
